home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / tmapcube / tmapcube.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  6.8 KB  |  152 lines  |  [TEXT/ttxt]
  1.  
  2.     Anfy Texturemapped 3d Cube - Copyright (C) by Fabio Ciucci 1997-99
  3.  
  4.  
  5. This applet can map on the faces of a cube with any GIF/JPG image, used 
  6. as texture. This applet contains the code by Cristiano Tagliamonte and 
  7. Martin Zettergren, used under a licence.
  8.  
  9. The animation jnn.gif is a courtesy of mstanya@bigfoot.com
  10.  
  11. This applet is fully parameterized, so you can change the size and movements
  12. of the cube.
  13.  
  14. **************************************************************************
  15.  
  16. NECESSARY FILES.
  17.  
  18. As well as images for the faces and optional background and/or foreground 
  19. images, the following 3 ".class" files must be uploaded: 
  20.  
  21. TmapCube.class
  22. Lware.class
  23. anfy.class
  24.  
  25. Plus, TmapCube.jar for speedy loading on recent browsers.
  26.  
  27. **************************************************************************
  28.  
  29. EXAMPLE.
  30.  
  31. Insert the <applet> tag in your html document as follows to add this applet
  32. to your page (Comments after the ";" symbol are code explanations and
  33. acceptable min/max values. They are not part of the applet language):
  34.  
  35.  
  36. <applet archive="TmapCube.jar" code="TmapCube.class" width="256" height="256">
  37. <param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
  38. <param name="regcode" value="NO">          ; Registration code (if you have it)
  39. <param name="reglink" value="NO">          ; Optional URL link when the applet
  40.                                            is "clicked".
  41. <param name="regnewframe" value="YES">           ; Reglink opened in new frame?
  42. <param name="regframename" value="_blank">       ; Name of new frame for reglink
  43. <param name="statusmsg" value="Tmapcube applet">  ; Statusbar message
  44. <param name="res" value="1">                 ; Resolution (1 .. 8)
  45. <param name="image1" value="face1.gif">      ; Face 1
  46. <param name="image2" value="face1.jpg">      ; Face 2
  47. <param name="image3" value="face2.gif">      ; Face 3
  48. <param name="image4" value="face2.jpg">      ; Face 4
  49. <param name="image5" value="face3.jpg">      ; Face 5
  50. <param name="image6" value="face3.jpg">      ; Face 6
  51. <param name="interactive" value="YES">      ; Interactive mode ("YES" - "NO")
  52. <param name="lightsourced" value="YES">     ; Lightning ("YES" - "NO")
  53. <param name="lightpower" value=95>          ; Light power (1..100)
  54. <param name="lightmin" value="10">          ; Light min power (1..511)
  55. <param name="lightmax" value="500">         ; Light max power (1..511)
  56. <param name="rotx" value="4">               ; X Rotation speed
  57. <param name="roty" value="6">               ; Y Rotation speed
  58. <param name="rotz" value="8">               ; Z Rotation speed
  59. <param name="backimage" value="NO">         ; Optional background image
  60. <param name="backr" value="64">             ; Red in background (0 .. 255)
  61. <param name="backg" value="96">             ; Green in background (0 .. 255)
  62. <param name="backb" value="160">            ; Blue in background (0 .. 255)
  63. <param name="clearback" value="YES">        ; Clear the background ("YES" - "NO")
  64. <param name="overimg" value="NO">           ; Optional image over applet
  65. <param name="overimgX" value="0">           ; Over image X offset
  66. <param name="overimgY" value="0">           ; Over image Y offset
  67. <param name="memdelay" value="1000">        ; Memory deallocation delay
  68. <param name="priorityL" value="3">          ; Loading task priority (1..10)
  69. <param name="priority" value="3">           ; Task priority (1..10)
  70. <param name="MinSYNC" value="10">           ; Min. milliseconds/frame for sync
  71. Sorry, your browser doesn't support Java.   ; Message for no java browsers.
  72. </applet>                                   ; End of applet tag
  73.  
  74. *****************************************************************************
  75.  
  76. INSTRUCTIONS.
  77.  
  78. The following instructions describe how to change parameters:
  79.  
  80. Attempting to change the "credits" parameter will disable the applet.
  81.  
  82. To activate the reg parameters read the shareware registration notes.
  83. In the "regcode" parameter, place the registration code you purchased
  84.  from the author. If the code is correct and the applet is run from
  85. the registered domain name, you can use "link" parameters to link to a URL
  86. when the applet is "clicked".
  87.  
  88. If you set "regnewframe" to "YES", you can specify a specific frame location
  89. for the reglink:
  90.  
  91. "_blank"  : To load the link in a new blank unnamed browser window.
  92. "_self"   : To load the link into the same window the applet occupies.
  93. "_parent" : To load the link into the immediate FRAMESET parent.
  94. "_top"    : To load the link into the top body of the window.
  95.  
  96. You can also set a custom frame name, such as "myframe1".
  97.  
  98. With the "overimg" parameter you can specify the name of an image that will
  99. be painted over the applet. The best options are transparent GIF images.
  100. NOTE: Animated GIF images are supported, but will be animated only on latest
  101.  browsers (Netscape 4 and Explorer 4 or newer).
  102.  
  103. With "overimgX" and "overimgY" you can center the image over the applet area.
  104.  
  105. You can load up to 6 different images to map on the faces of the cube.
  106. If you place the same image on all 6 face parameters, all faces will
  107. display the same image. Otherwise, you can display 2, 3, 4, 5, 6 different
  108. images. The best choices are 3 and 6. 
  109.  
  110. With 3 different images placed in the same order of the example above, there
  111. are no duplicate images shown in a frame, and you have to load only 3 images.
  112. If you want to fill all the faces with different images, it can be done but
  113. loading time will increase greatly.
  114.  
  115. The GIF/JPG images MUST either be ALL 256*256 pixels in size, or ALL 128*128
  116. in size. No other sizes are allowed, and  you can't mix 128*128 images with
  117. 256*256 images in the same cube applet. (Using 256*256 images is useful only when
  118. applet size is greater than 150).
  119.  
  120. You can mix GIF and JPG formats in the same cube; what you can't mix is image
  121. size.
  122.  
  123. "Res" is a sort of fine resolution. Res=1 equates to normal pixel size, res=2
  124. means doubled pixels etc. With res = 1, the image is best quality but slow;
  125. with res = 2 or 3, the speed will be increased but image quality suffers.
  126.  
  127. You can activate or deactivate the interactive mode with "interactive"
  128. parameter: if set to "YES", users can control the cube movements with a mouse
  129. pointer.
  130.  
  131. Setting the "lightsourced" parameter to "YES" will enable the lightsourcing; 
  132. setting it to "NO", shading will be displayed.
  133.  
  134. With "lightpower" you can choose a light intensity from 1 to 100.
  135. With "lightmin" and "lightmax" parameters, you can choose the darker and lighter
  136. values allowed, between 1 and 511.
  137.  
  138. With the "rotx", "roty" and "rotz" parameters, you can control the rotation
  139. speed of the cube.
  140.  
  141. With "backr", "backg" and "backb" parameters, you can control the RED, GREEN
  142. and BLUE components of the background colour.
  143.  
  144. You can load a background image by placing its name in the "backimage" 
  145. parameter. This image must be the same size as that of the applet if res=1,
  146. half the size of the applet if res=2, and so on.
  147.  
  148. You can disable the background clear routine if desired by setting "NO" to "
  149. clearback" parameter.
  150.  
  151.  
  152.